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SYNCLAVIER INTERNALS 


Section 1 -- Organization of Sources 


The Synclavier sources are kept in a tree of sub-catalogs. There 
are two primary trees: 


SYNSOU 


Contains Synclavier sources which have been modularized, 
especially including code for the top-level, screen manager, 
sample-to-memory and utilities. 


SYNRSOU 


Contains Synclavier real-time sources which have not yet been 
modularized. 


SYNSOU 


The SYNSOU catalog contains many sub-catalogs which in turn 
contain the XPL source files. The currently defined sub-catalogs 
are: 


D4OMOD - Printer output and hard copy 

D42MOD - Special output routines for DEC voice box 

DBUGMOD - Sequence debugger code (for internal use only) 

DIRMOD - Synclavier directory screens 

EDITMOD - Sequence editor screen 

ERRMOD - Synclavier error messages 

FILEMOD - File searching code 

GETMOD - Code for get.next.event 

GLOBMOD - Global variables needed everywhere 

GPRMMOD - A set of general buffered disk read routines 

LINKMOD — Miscellaneous routines 

LODMOD - Routines to talk to the direct-to-disk over SCSI 
MATHMOD - High precision math and time conversion routines 
MNOTMOD =- Music notation screen 

MONOMOD - Routines for mono sampling playback 

MOUSEMOD - Module for mouse code 

OPTMOD - Optical disk screen 

PARMMOD - Module for processing Synclavier parameters 

PATCHMOD - Sound file patch screen - connects sound files to keys 
PLOTMOD - Plot library 

PMEMMOD - Old (16 bit) poly memory interface, now calls polymod 
POLYMOD - Module with code to access poly memory 

RECMOD - Recorder screen (another sequence editor) 

ROUTMOD - MIDI and multi-channel routing display screens 
SCRNMOD - Screen drawing primatives (draw, box, etc...) 

SEQMOD - Sequence manipulation primatives to operate on data str. 
SMGRMOD - Module for screen manager 
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OTHER CATALOGS 


There are several other top-level catalogs which contain files 
needed to compile the Synclavier software: 


SYNRDCLS - External declarations for real-time modules (SYNRSOU) 
SYNAUXS - Auxiliary literals used by only some modules 

SYNLITS - Basie common literals for the Synclavier 

SYNMODS - External declarations for each module in SYNSOU 
SYNMAINS - Main programs and do files for Synclavier compilations 
SYNCOMS - Compilation’flag sources for different system versions 


There are also several catalogs which contain relocatable 
binaries for the Synclavier software: 


# SYNLIBS - Relocatable binaries for each module (from SYNSOU) 

SYNTLIBS - Relocatable binaries for terminal screens (from SYNSOU) 

# SYNRLIBS - Relocatable binaries for Synclavier real-time modules 
(from SYNRSOU) 
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Section 2 -- Internal Memory 


There are several different kinds of memory in a Synclavier 
system. The ABLE computer has memory directly available to the 
processor known as INTERNAL MEMORY. There is additional memory used 
for storing sequences, timbres and other data structures known as 
EXTERNAL MEMORY. A system may also contain POLY MEMORY, used 
primarily for storing sampled sound data. 


aol 


OVERALL STRUCTURE 


INTERNAL MEMORY is that which is directly available to the CPU 
for storing instructions and data. Information stored in INTERNAL 
MEMORY is accessible more quickly than other memory in the system. 
The 16 bit architecture of the ABLE processor limits the amount of 
INTERNAL MEMORY to 64K words. The structure of INTERNAL MEMORY looks 
like: 


INTERNAL MEMORY 


LOC 0 | STARTUP CODE: "PCI TO LOAO" 


PTR TO CONFIG TABLE 


C#CONTAB = LOC 1 
BALANCE OF STARTUP CODE 


(FORMAT DESCRIBED | --------------------------- -_ 
IN :-XPL:SYSLITS) } CONFIGURATION TABLE <--- 
| sis iat iach taonaii a ros 
H STRING & DATA CONSTANTS 
H Se ee SST SR eee fer weer an Oe fo ' 
H PROGRAM CODE ; 
(SIZE OF LARGEST | Petter nnn = === ~—| 
SWAPPING PROCEDURE)} SWAP AREA : 
jee ease cena seen ! 
H VARIABLES ‘ 
jr tert rece ee eee eee H 
: STACK H 
| SS eeneieraaeieeenenctersemeieneseniamnarsarintee pS eminereS sinter + 
H FREE (*) | NOTE BLOCKS H 
(TOP-1024) ----=-- > | peter enn +--+ === | ween ----- = —|} 
H OVERLAY ROUTINE | PARTIAL BLOCKS } 
(TOP-512)------- > | motte - $= -- | teen nae + 
| SYSTEM STATE VARIABLES H 
(TOP = 6-1) 60K{--------------------------- —| 
: BOOTLOAD ROM H 
OK 4-3 nnn + 


(*) NOTE: WHEN RUNNING THE SYNCLAVIER PROGRAM, THIS SPACE FOLLOWING THE 
STACK IS USED FOR NOTE BLOCKS AND PARTIAL BLOCKS. THE "OVERLAY 
ROUTINE" IS SWAPPED OUT TO MAKE ADDITIONAL ROOM FOR THEM. THEY ARE 
ALLOCATED AT RUN-TIME OFF OF THE "HEAP" BY THE SYNCLAVIER PROGRAM. 
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If an XPL procedure is declared to be a swapping procedure it is 
not always resident in INTERNAL MEMORY. The compiler automatically 
takes care of allocating a place for it to be loaded in EXTERNAL 
MEMORY. When it is called for execution, it is copied for you to the 
"SWAP AREA" in INTERNAL MEMORY and program control is passed there. 
When another procedure is swapped in to the "SWAP AREA", the previous 
routine is over-written. Only the code is swapped in; the values of 
any static variables are preserved in INTERNAL MEMORY across swaps. 


Most swapping procedures in the Synclavier code are declared to 
be "SWAPABLE" [sic]. This is a literal which translates to 
"RECURSIVE SWAP" for the XPL compiler. It means that variables 
default to AUTOMATIC (created on the stack) rather than STATIC (in 
internal memory). 


The "SWAP AREA" reserved for a given program is the size of the 
Single largest swapping procedure declared by that program. See the 
section in the XPL manaual on "Swapping Procedures" for more 
information on the subject. 


The Synclavier software is loaded into the PROGRAM CODE and SWAP 
AREA portions of INTERNAL MEMORY for execution. Like any executing 
program, it also uses the STACK and VARIABLES segments. QUEUES of 
pending notes are built in the NOTE BLOCK and PARTIAL BLOCK areas 
which are described in more detail below. 


QUEUES 


NOTE and PARTIAL BLOCK structures for notes which are currently 
active, or will be very soon, need to be in INTERNAL MEMORY for the 
sake of real-time speed of data access. Most of the sequence and 
timbre information is stored in EXTERNAL MEMORY, because it is much 
larger than INTERNAL MEMORY. The Synclavier software looks ahead 
80msec in real time and builds QUEUES of NOTE BLOCKS which in turn 
point to zero to sixteen PARTIAL BLOCKS in INTERNAL MEMORY. 


There are several QUEUES present in INTERNAL MEMORY. Each one 
has a global pointer to the start of the QUEUE which is a linked list 
of NOTE BLOCKS. The currently defined pointers and their QUEUES are: 


NOTELIST -> First NOTE BLOCK in the ACTIVE NOTE LIST QUEUE 
KBDLIST -> First NOTE BLOCK in the NEW KEYBOARD NOTES QUEUE 
SEQLIST -> First NOTE BLOCK in the NEW SEQUENCE NOTES QUEUE 
SEQLAST -> Last NOTE BLOCK in the NEW SEQUENCE NOTES QUEUE 
TIELIST -> First NOTE BLOCK in the TIED NOTES QUEUE 

TIELAST -> Last NOTE BLOCK in the TIED NOTES QUEUE 

NFREEP -> First NOTE BLOCK in the FREE NOTE BLOCK LIST 
PFREE -> First PARTIAL BLOCK in the FREE PARTIAL BLOCK LIST 
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QUEUE STRUCTURE 


NOTE BLOCK PARTIAL BLOCK PARTIAL BLOCK... 
Woe ee tn te ea 5 eee te ea ee + Be ere ee ee a ae ee 
i PTR TO NEXT NOTE j{ +=>} FORWARD PTR i>} FORWARD PTR 
' BLK IN THIS QUEUE | | |-------------------- Lenn nna n nnn n nnn an 
| Soe ec een enna een ol a OTHER DATA H { OTHER DATA 
1 OTHER DATA era i.) eee eee 
ns —1} 
| PTR TO PARTIAL BLK {+ H H 
acta nc enn immmam! Jjortineensneciunsien sipeinienntnenemasiomnnice sen pattems > 
H OTHER DATA ‘9 UP TO SIXTEEN OF THESE 
tne niacin stan isentmnerinti, - PARTIAL BLOCKS MAY EXIST... 

NOTE BLOCKS 


NOTE BLOCKS are allocated and placed on one of the QUEUES just 
described. In order to use the offsets defined for a NOTE BLOCK (eg: 
NFPTR, TIMBRE...), you must set the pointer NPTR to the start of the 
NOTE BLOCK you wish to access. 


NOTE BLOCK (27 WORDS) 


:SYNLITS: QUELITS 

NPTR—->} FORWARD PTR 1 NEPTR 
| TIMBRE NUMBER | TIMBRE 
' TRACK NUMBER | TRACK 
ae DATA | 
| RECORDING PTR WORD | ‘RECW 
RECORDING PTR SECTOR {RECS 
aaa DATA ! 
| PARTIAL BLOCK LIST PTR} PTLST 
er a TY a oa etn ee er ee en + 


PARTIAL BLOCKS 


A chain of zero to sixteen PARTIAL BLOCKS are allocated and 
pointed to by the NOTE BLOCK just deseribed. A note may have one to 
four partials by itself. This expands to a maximum of sixteen 
possible PARTIAL BLOCKS when you take the features "chorus" and 
"partial chorus" into consideration. In order to use the offsets 
defined for a PARTIAL BLOCK (eg: PFPTR, PLOG...), you must set the 
pointer PPTR to the start of the PARTIAL BLOCK you wish to access. 
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PARTIAL BLOCK (80 WORDS) 


:SYNLITS: QUELITS 
PPIR-->} FORWARD PTR | PFPTR 
' CHORUS PTR | PLOG 
ee DATA ! 
~ VOLUME ENVELOPE Q FORW PTR ! EOF 
"VOLUME ENVELOPE Q BACK PIR { EQB 
"FM ENVELOPE Q FORWARD PTR {TOF 


' 
' 

“Fy ENVELOPE Q BACKWARD PTR {; IQB 
' 


DECAY FORWARD PTR FOF 
"DECAY BACKWARD PIR} FOB 
a ae ! 
~~ <GHOST BLOCK PTR} GFPTR 

ea maar + 
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Section 3 -- External Memory 


External memory is not directly addressable by the ABLE CPU. It 
is accessed as a device is through the use of XPL "read" and "write" 
statements. Because it is addressed using two registers totalling 24 
bits, it is possible to have a maximum of 32 megabytes of external 
memory. 


External memory is divided into SECTORS of 256 words each. Two 
address and two data “registers are used to access it. An address 
register "MAM" gives the sector number (Memory Address 
Most-significant). A second address register "MAL" is an offset into 
the selected sector (Memory Address Least-significant). Once an 
address is specified in "MAM" and "MAL", data (a 16-bit word) is read 
or written from the "MD" register. A fourth register "MDI" may be 
used to access data and auto-increment the MAM and MAL pointers to 
the next seqential word, crossing sector boundries if necessary. 


EXTERNAL MEMORY 
MAM 2: 0 -nennn= Dm nremeneneteyaterseenereneeenensmenenenseneseneeene + 
MAL = Offset -->| SECTOR-0 (256 words) 


The values of MAM, MAL, MD and MDI are defined in 
:SYNLITS:GLOBLITS. The following example reads the first 1024 words 
of external memory into an array in internal memory, and leaves zeros 
in place of the data in external memory: 


write(MAM) = 0; /* Point at the first sector */ 
write(MAL) = 0; /* No offset into the first sector */ 
do i=0 to 1023; 

array(i) = read(MD); /* Read data word #*/ 

write(MDI) = 0; /* Clear location and point at next */ 
end; 


OVERALL STRUCTURE 


When the Synclavier program is running, the lower addresses of 
external memory are used to store sequence, timbre and note 
information for the user. Swapping procedures are stored in the 
upper addresses. Swapping procedures are allocated at compile time; 
all other structures shown here are built at run-time. 


The major data structures begin at a pointer, named ???.PTR with 
a length of ???.LEN. Note that the .LEN value is the current length 
of real data stored in that particular area. There is often a "gap" 
maintained at the end of each data structure so new entries can be 
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at, 


made without shuffling everything around. Usually the largest "gap" 
is kept following the NAH information to allow the sequence to grow 
quickly. As space becomes tight, the gaps are reduced - to zero if 
necessary. 


EXTERNAL MEMORY 


fame enenmntaecienabennnerasreatmenenesaret en + 

SECTOR 0 } ALL ZEROS H 
BAS. PTR--> | -----------——----—=~-----——- | 
BAS. LEN | SEQUENCE BASE SECTORS (2) |} 
PAR. PTR A> | ea tenesenieenrneranenatensnsecennsvertionee a 
PAR.LEN H TIMBRE PARAMETER AREA { 
NAH. PTR—=> | --a—=-—-=———- nn 
° | NOTE AREA HEADER (NAH) H 
WIEN foes oes wee 
. | TRACK HEADER SECTORS AND H 

e | NOTE LIST SEGMENTS H 

. i SU Gs Sy he Se eS oe ee he Se eee H 

‘ H FREE SPACE { 
BNK. PIR—~> | —------=-n——- === === 
BNK.LEN H TIMBRE BANK H 
INF . PTR—> | ---------------------—------- 
INF. LEN ; MUSIC PRINTING SEQ INFO 1 
TIM. PIR—> | —-==——-=- == === === === == 
‘TIM. LEN H TIMBRE HEADS | 
TRD. PIR--> | ~---------------------—----- 
TRD.LEN | TIMBRE TERMINAL DISPLAY INF | 
EXAMOUNT—> |---—=—-—---------—---------—~ 
MSFIRST==> | MONO SAMPLING BUFFERS { 
SMI Kane) | amen renin 


LOOK UP TABLES i 


The next diagram shows the relationship between the track header 
structures. The NOTE AREA HEADER is a single sector containing up to 
256 pointers to TRACK HEADER SECTORS (relative to NAH.PTR). There is 
also a TRACK LOOK UP TABLE in the LOOK UP TABLES area which has the 
same structure, but is 256 absolute pointers to the TRACK HEADER 
SECTORS. 


Each TRACK HEADER SECTOR has several pointers into the NOTE LIST 
SEGMENT for that track. They include pointers to the start of the 
NOTE LIST SEGMENT, to the currently playing note, and to the start 
and end of loops. The individual structures are described in more 
detail later. 
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TRACK HEADER STRUCTURE 


NOTE AREA HEADER or 


TRACK LOOK UP TABLE Rack HEADER SECTOR NOTE LIST SEGMENT 
Nee eee Ree ee ee so er ee et 
H SECTOR # toy! PTR TO NOTE LST SEG{-->{ PTR: NEXT NOTE LST | 
---=-------------- ee ees i 
H SECTOR # ' ' OTHER DATA H | PTR: PREV NOTE LST | 
He ee —| H EN Eee ee ' a aaa a —| 
' SECTOR # H | CURRENT PLAY PTR {==>} OTHER NOTE DATA H 
| pomanaenanan-=a==- —} 0 feeeane------------ —| | ‘ 
H e , @ f OTHER DATA H ' . 1 
‘ {0 Jenennwnn--n=---=-- —! | : 
H ° H | OVERALL LOOP PTR j-=>} ° 1 
prcma nena a ennnanenna= $0 [eeeeeennnennn----- —| |} ‘ 
| IND LOOP START PTR {==>} ° H 
| ------------------ —} | ‘ 
| IND LOOP END PTR {-->} ‘ 
| srteeeernenneenaneneneomemnesanenam —- | : H 
H OTHER DATA H H . 
aa ai a aa a eee eerste memeemmneeemee meena + 


The next diagram shows the relationship between the timbre data 
structures. The TIMBRE LOOK UP TABLE. is a single sector in the LOOK 
UP TABLES area containing up to 256 absolute pointers to TIMBRE 
HEADS. Each TIMBRE HEAD has several pointers into the TIMBRE 
PARAMETER AREA for that timbre. The individual structures are 
described in more detail later. 


TIMBRE STRUCTURE 


TIMBRE LOOK UP TABLE TIMBRE HEAD TIMBRE PARAMETER AREA 
caiman enamine: + cee See eRaeE ER. ceaeananaaeeaatmamaamdat 
SECTOR # Fomoee VOLUME LEVEL 1 +t BASIC INFO #1 | 
g nnerericeestencnnmsnmemintiomeriten ‘RemEninetbe 1 2 | sae 
1 SECTOR # H | #1 PARTIAL PTR {-+ {| TIMBRE FRAMES #1 
 aenneemmer A, 1 en 
i SECTOR # { | #2,3,4 PARTIAL PTR | +>;  PINFO BLOCK #1 | 
 -oiaeiememmzen: pr Rame ED \seuepeeeeeremaniaemianes 
i . #1 PINFO PTR im+ | 
‘ ee | (ABOVE CAN REPEAT } 
' . OTHER DATA | | UP TO FOUR TIMES) {| 
amelie ae aieenin el aeimatmets: ~ jem rereemneniaanneeneninneniaemnem i 4 H 
MISC PTR im+ | 
Bingen Rr meee EE gememamcor enact 
TINFO PTR 17> I TINFO BLK 
‘eamassincocenanmmanicapmeeaia SE i \aeenaegcncmnoecenmmametes ' 
' OTHER DATA 1 +4 MISC AREA ' 
meee H petremerieeremeremereeeneneenmentines + 
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The following diagrams are an expansion of the previous general 
pictures of external memory data structures. No attempt is made to 
include every piece of data. Rather, the general types of 
information and their relative locations are shown. Pointers to 
other data structures are included so the inter-relationships can be 
seen, 


It is worth noting that many of the pointers used in external 
memory are RELATIVE to a base pointer for the data structure 
containing them. This is so that information in external memory can 
be shuffled around without having to re-calculate all the pointers. 
Only absolute pointers bécome invalid. 


SEQUENCE BASE SECTORS 


SEQUENCE BASE SECTORS contain miscellaneous information and 
pointers to timbres, notes and music printing. This information and 
the relative pointers are only updated when about to write a sequence 
out to the disk. They are not kept up to date during run time. 


SEQUENCE BASE SECTORS 


:SYNLITS:THDLITS 
BAS, PT R<-> 42 e nnn nnn nnn nnn nena nnnenan + 
! ' 
e i] ! 
‘ H GENERAL SEQUENCE INFO H 
! ! 
Jae peer | 
. ' RELATIVE PTR TO BASE SECTOR | SEQ.BAS 
BAS LEN [ewe neem mean i 
e ' REL PTR TO TIM PARAM AREA ; SEQ.PAR 
° H Sa aa aa aa a —| 
° ' RELATIVE PTR TO NOTE AREA { SEQ.NAH 
1 a | 
° Sa ae i aii i a ci aay | 
e ' RELATIVE PTR TO MUSIC PRINT ; SEQ.INF 


TIMBRE PARAMETER AREA 


The TIMBRE PARAMETER AREA is where the partials are stored for a 
timbre. A timbre can have up to four partials. Each partial starts 
out with a 46 word block (or just a word "SUP" (-2) if the partial is 
not used). Following the 46 word block are some optional blocks of 
data which are variable length. All four partials must be specified, 
or marked unused with "SUP", A good concise example of some code 
which steps through this structure may be found in the procedure 
"FIND.TIMBRE" in the file :SYNRSOU:03-PRIM: 131-SDF1. 
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TIMBRE PARAMETER AREA 
:SYNLITS: PRMLITS 


| BASIC PARTIAL INFO (46 WDS) | 
46=NUM.PARAMS { OR A SINGLE WORD "SUP" (-2) | P.* 
! ! 
' i] 
' 
! 


OPTIONAL{ } "MOR" (-1) 
{|--------------- : 
TYPE{ | "TF TYPE" (0) 
{ |J--------------- 
CLEN{ |} "LEN. TIMB.FRAME" (172) } 
{ l= sn a= Ye Ga em 2 gh eh © Sen ems Sa 
{ | TIMBRE FRAME (172 WORDS) | NOTE: THERE CAN 
{ | = 8 SYSTEM WORDS ' BE MORE THAN ONE 
{ | = 12 PARAMETERS ! TIMBRE FRAME OR 
{ | = 24 COEFFICIENTS ' PATCH TIMBRE FRAME 
{ | = 128 WAVE TABLE ENTRIES | IN A PARTIAL. 
| een en nnn nnn nanan 
OPTIONAL{ } "MOR" (-1) 
{ |--------------- 
TYPE{ | "PT. TYPE*™ (1) H 
{ |--------------- 
CLEN{ } "PT.LEN" (48) 
{ j--------------- 
{ | PATCH TIMBRE FRAME (48 WDS) } 
| penn nn nnn n nnn nen nanan nnne --! 
i: "PINFO" (=3) i 
OPTIONAL{ |- -------------- 
PINFO.LEN{ | PARTIAL INFO (32 WORDS)  PI.#* 
p-rremertonimnemcrnar ie ietnarnnNe innit + 
NOTE: THE ABOVE REPEATS 4 
TIMES (ONCE PER PARTIAL) 
AND THEN IS FOLLOWED BY: 
acta agement + 
{ } "TINFO" (=) 
OPTIONAL{ !--------------- 
TINFO.LEN{ } TINFO BLOCK (96 WORDS) | TI.* 
© sith lank ni dela cect ene tin dtd alah dah ab dtedinntaiebbdsagaien ——| 
| "MISC AREA" (8 WORDS) | 
sae 


NOTE AREA HEADER 


The NOTE AREA HEADER is a single sector containing 256 pointers, 
one for each possible track. Each pointer is a sector number, 
relative to NAH.PTR, pointing to the track header sector for that 
track. If there is no active track corresponding to a given pointer, 
it is zero. The first two tracks are reserved for the keyboard and 
split keyboard respectively. 
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NOTE AREA HEADER (NAH) 
:SYNLITS: THDLITS 


TRACK HEADER SECTOR 


One TRACK HEADER SECTOR exists for each of the active tracks. It 
is pointed to by the NOTE AREA HEADER data structure. Each TRACK 
HEADER SECTOR is exactly one disk sector in size. The sector 
contains miscellaneous information for the track such as loop and 
play pointers and real-time effects. There is also a pointer to the 
first NOTE LIST SEGMENT which is the first block of actual notes on 
the track. 


There is a linked list of tracks, sorted by the next event to 
occur in real time. The head of this list is a global pointer, 
"NEXT. EVENT.QUEUE" which points to the TRACK HEADER SECTOR with the 
next up-coming event. Within each TRACK HEADER SECTOR are two 
pointers, THD.NEVF and THD.NEVR which are forward and reverse 
pointers to the next TRACK HEADER SECTORS in this list. As time 
advances, new TRACK HEADER SECTORS are appended to the end of the 
linked list. As an event occurs, the top track is removed from the 
head of the list. 
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TRACK HEADER SECTOR 


:SYNLITS: THDLITS 
H PTR TO START OF NOTE LIST THD.FOR (*) 
"REVERSE PTR - ALWAYS ZERO | THD.REV 
nae TRACK NUMBER | THD. TRK 


~ FORWARD PTR TO NEXT EVENT ; THD.NEVF 


! 
_ REVERSE PTR TO NEXT EVENT | THD.NEVR 

en sehemienbenian ann enaenedwpdebeebisenusmnmbceuiabesesan ' 
BLOCK OF DATA FOR THIS 1 
TRACK i 
ad tiie cab —! 

CURRENT PLAY PTR - WORD # ; THD.WRD (*) 
! 


THD.SEC (*) 


1 
1 
! 
' 
MORE DATA FOR H 
THIS TRACK 
! 
! 
OVERALL LOOP PTR - WORD # | THD.LP.WRD (*) 
! 
! 
LOOP PLAY PTR - SECTOR # {| THD.LP.SEC (*) 
! 


MORE DATA FOR 
THIS TRACK 


THD.ILS.WRD (*) 


MORE DATA FOR 


' 

' 

! 

! 

! 

1 
INDEPENDENT LOOP PTR - S # | THD.ILS.SEC (*) 

' 

THIS TRACK 

! 

! 

‘ 


! 
THD.ILE.WRD (*) 
! 


1 
iter LOOP END PTR - SECTOR # {| THD.ILE.SEC (*) 


MORE DATA FOR 
THIS TRACK 


(*) INDICATES A POINTER INTO THE NOTE 
RECORD LIST FOR THIS TRACK 


NOTE LIST SEGMENT 


A NOTE LIST SEGMENT is a linked list of sectors containing note 
records. Each sector contains a forward and reverse pointer and up 
to 126 2-word note records. Special format note records may also 
exist which are 4 words long. Note that the pointers to the first 
and last note records point at actual data. NLS.FIRST and NLS.LAST 
define the size of the block which can POTENTIALLY hold note records. 


3) EXTERNAL MEMORY oat i law SYNCLAVIER INTERNALS 


NOTE LIST SEGMENT 
:SYNLITS: THDLITS 


PTR: NEXT NOTE LIST SEGMENT 1 NLS .FOR 
ee ' 

t P PTR: PREV NOTE LIST SEGMENT | NLS.REV 
| een annem nnn ' 

H TRACK NUMBER | NLS. TRK 
i 


' 
+--| PTR TO FIRST NOTE RECORD NLS.FP 
! 
1 
' 


ryof_FIE TO St wore aco wu 

| >| (FIRST) | NLS.FIRSTL 

| : NOTE RECORDS 

| (LAST) | NLS. LAST 

s—-—>! sos FLAG AT END (1) ‘+ NLS. EOS 
 aalneieoneeasaaemiiameceameancmareeamemeneaan - 


NOTE RECORDS 


NOTE RECORDS contain information about notes to play, including 
starting time, duration and key to play. They are also used to make 
changes in real-time effects which can effect some or all of the 
currently active notes. 


There are three general rules used in determining the format of a 
NOTE RECORD: 


1. If the LSB of the first word is set, the NOTE RECORD length will 
be 4 words, else it will be 2 words. 


2. If the MSB of the first word is set, the NOTE RECORD is in 
"alternate format", if clear it is in "normal format". When in 
alternate format, the next 4 upper bits of the first word are 
used to indicate what type of "alternate" record it is. 


3. For all 4 word records, the lower 6 bits of the last word must be 
"62" (VEL.NOTE). This is necessary to determine the length of 
the record when stepping through in reverse order. 


A NORMAL FORMAT 2 WORD RECORD is the simplest NOTE RECORD. It 


represents notes in the range of 12 to 72 (C1 to C6). The velocity 
is assumed to be full value (RTE.MAX = 255). 
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NOTE RECORD (NORMAL FORMAT, 2 WORDS) 
:SYNLITS:SYNCLITS 


DATA PRESENT==>{ O}HI-DUR{|START TIME DELTAIO | 
BITS IN FIELD—->} Tit nb iagieit oe Gowen Osiaeisteneiey Tes 


! 1 
! 1 
| LOW DURATION | KEY NUMB { 
! ! 
! ' 


wuleleisil adware ours sce 


pr a a ee + 


A NORMAL FORMAT 4 WORD RECORD is used to represent keyboard notes 
0 to 84 (CO to C7). Thé full range of note velocity values may also 
be stored in this record. The duration and starting time fields are 
the same. 


NOTE RECORD (NORMAL FORMAT, 4 WORDS) 
: SYNLITS:SYNCLITS 


DATA PRESENT==>{ O{HI-DUR{START TIME DELTA}1 
BITS IN FIELD—>} Viv elic we taweatelOseuseecan't 


$ on nn nn wo = = -- == + 


1 
LOW DURATION | KEY NUMB 


ieee eee wescwe | «ves Oeucs 


MSGS CRSOCERCNCE CEU LURS DOCS 


1 
VOLUME/OTHER {RAISE/LOW; 62 


CECTROCER CEO CROS CXS TT EOS 


1 
' 
' 
| SWITCH/FLAG BITS | RTE DATA 
! 
i 


+ 
' 
1 
i 
' 
| 
t 
i 
1 
1 
1 
1 
i 
! 
i 
i 
! 
1 
I 
{ 
1 
' 
' 
| 


An EXTENDED REST note record is needed to specify a rest of 
longer than 1023 milliseconds in a single note record. 


NOTE RECORD (ALT FORMAT: EXTENDED REST, 4 WORDS) 
:SYNLITS:SYNCLITS 


DATA PRESENT-=>; 1 
BITS IN FIELD-->; 1 


MOST SIG START DELTA 


cee eesseetcecexeses lex 


| © {START TIME DELTA}1 { 
! 

1 

CSCC CSASOOCS lO SGwae TESS eeCS 
iS eeSencsivies (OeSiewecsesees 


UNUSED FIELD 1 62 


siiewsacses lOcewrwwocewsrcOs 


! 
! 
! 
! 
1 
i 
| LEAST SIG START DELTA 
i 
: 
1 
1 
' 
! 
' 
' 
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An INDEPENDENT LOOP START record is used to mark the start of a 
loop present in this track independent of other tracks. Once a track 
has entered a loop, it will continue playing between the start and 
end loop records without exiting the loop. Only the first word of 
the 4 word record contains any useful data. 


NOTE RECORD (ALT FORMAT: INDEPENDENT LOOP START, 4 WORDS) 


: SYNLITS: SYNCLITS 

Sa i ana i a aaa + 

DATA PRESENT=->; 1}; 1 {LOOP START TIME DLT}1 | 
BITS IN FIELD-->} Wiel Swicwedavetcecedeseciet 
Il earning lc bigmen igus eabbadniniaiainaleeiocadé ' 

' ! 

H UNUSED FIELD i 

H SECRSSOSE RG © IO ned b:0:5 05:00:09 } 

[ee mainiamminraienisiianiaee mmf 

H UNUSED FIELD H 

H wibre Wrers eieteimieian ew oi0ss\ereieteceseces H 

amr aaa ada dense aa RD i 

{ UNUSED FIELD | 62 | 

H esbieaaiainrab oil leinis ei keieiwiae tive H 

= aaa a Rak a + 


An INDEPENDENT LOOP END record marks the end of valid note 
records for this track. As time continues to advance, the track will 
loop indefinitely back to the INDEPENDENT LOOP START record. 


NOTE RECORD (ALT FORMAT: INDEPENDENT LOOP END, 4 WORDS) 
:SYNLITS: SYNCLITS 
eee ee + 
DATA PRESENT=->{ 1; 2 {LOOP END TIME DELTA}1 | 
BITS IN FIELD-->} L gla sueuswites Wowdweeeet tay 
! 


UNUSED FIELD 


aie enwhidiee ewe lOS wvecieeeeeweae 


1 
' 
1 
' 
eee ne ee ee ee ee ee ee eee: ———| 
UNUSED FIELD H 

see SESEWECHs TON CRTE ESCH OES H 
! 

' 

' 

' 

! 

‘ 


UNUSED FIELD | 62 


Savieiewe swe Osweswea sree paDe 


For more information on the exact format of the data in each of 
the above fields, refer to the definitions in :SYNLITS:SYNCLITS or to 
Tim Schaaff's memo "SYNCLAVIER NOTE RECORD FORMATS", 
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TIMBRE BANK 


A TIMBRE BANK is a temporary storage area used to hold a bank of 
timbres read in from the disk. The format of the TIMBRE BANK is. the 
same as the TIMBRE PARAMETER AREA (see earlier description above). 
When the user selects a timbre bank, all the timbres in it are copied 
to this area. Then when a specific timbre is picked, it is copied to 
the TIMBRE PARAMETER AREA. 


If the entire bank will not fit in external memory, the system 
waits for the user to select a specific timbre. Then, that one 
timbre is copied directly from disk to the TIMBRE PARAMETER AREA. 
The size of the TIMBRE BANK is often zero, either because no new 
partials are being selected, or because the space was needed for 
other things (eg: active sequence and partial information). 


MUSIC PRINTING SEQ INFO 


The MUSIC PRINTING SEQUENCE INFORMATION is a block of data which 
is defined by and maintained for the music printing software. The 
format is considered "unknown" by the Synclavier software. A pointer 
to this block is maintained (INF.PTR) and the data is shuffled around 
to accommodate other areas as necessary. 


TIMBRE HEADS 


The TIMBRE HEADS area is made up of sectors containing 
precomputed information for the basic timbre and pointers to partial 
data in the TIMBRE PARAMETER AREA. All of the pointers into the 
TIMBRE PARAMETER AREA are relative to PAR.PTR. 


The TIMBRE HEADS area may also contain KEYBOARD LOOK UP TABLES. 
These are used when different sounds are mapped to various keys on 
the keyboard (eg: bass drum on middle-C, snare drum on middle-D, 
etc...); this is known as "patching". Each of the four partials for 
a timbre may be patched through a KEYBOARD LOOK UP TABLE, or they may 
not. The pointers in the TIMBRE HEAD are zero if no KEYBOARD LOOK UP 
TABLE exists for a partial; if non-zero they are relative to TIM.PTR. 
In the Synclavier code, sometimes the KEYBOARD LOOK UP TABLES are 
also refered to as the KEYBOARD PATCH LIST. 
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TIMBRE HEAD 
:SYNLITS: TIMLITS 


TIM. VOLUME. LEV 
PARTIAL PTRS (4 WORDS) | TIM. PARTIAL. POINTERS 
TIM. PINFO. POINTERS 
TIM.SYNTH.TYP 


' 
"KEYBOARD LOOKUP PTRS (4 WDS){} TIM.KBDTAB. PTR 
qaepusswassnncseseresteehenubebalesengndsenasusesununasen 1 
! 
' 
MISCELLANEOUS AREA PTR | TIM.MISC. POINTER 
' 
! 
| TIM.TINFO. POINTER 


KEYBOARD LOOK UP TABLE 
(ONE SECTOR; NO LITERALS DEFINED) 


PTR TO PATCH TIMBRE FRAME IN} } THIS REPEATS 
TIMBRE PARAMETER AREA } THREE WORDS 


H 

1 ' 

! ' 

| pe nnnnann == nanan n= - === === == | } PER KEY FROM 
| 0 IF MONO; 1IF STEREO |! } CO TO C7: 

| nen nna eaeneemenenenes ! } = 85 KEYS 
PTR TO FILE BLOCK IN } } —- 255 WORDS 
! EXTERNAL OR POLY MEMORY |} TOTAL 

1 


TERMINAL DISPLAY INF 


The TERMINAL DISPLAY INF area is scratch space used by the 
terminal for generating informational displays. An area is 
established to store data matching that which is displayed on the 
screen. Then, as time passes, information inside the Synclavier 
software is compared with the copy of the displayed data. If and 
when the data differs from what is on the screen, the terminal must 
be updated. This way, time only needs to be spent re-drawing parts 
of the display that are out of date. This technique is only one of 
many uses of the TRD area for displays. 
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MONO SAMPLING BUFFERS 


A MONO SAMPLING BUFFER is’ created in external memory to hold 
sound files when they are loaded from disk for the FM _ synthesizer. 
This block is only created on systems having FM synthesis. The 
format of the data is almost identical to sound files stored in poly 
memory. The MONO SAMPLING BUFFER is created with the smaller of the 
sizes: 


# 158 Sectors. 
# One half of all of external memory from the beginning up to the 
start of the LOOK UP TABLES. 


LOOK UP TABLES 


Some pre-computed LOOK UP TABLES are stored at the top of 
external memory, just under the swapping procedures. These include 
LOG, SINE and FREQUENCY tables. This saves the time of calculating 
the data during real-time Synclavier execution. A number of other 
blocks of information are stored here. Although not expanded further 
in this document, each block is named, shown in its relative position 
in upper external memory and the size in sectors is shown. For more 
information, see the file :SYNRSOU:08-INIT:600-INIT containing the 
procedure "SETUP.EXTERNAL.ALLOCATIONS", 
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LOOK UP TABLES 


MFM. PTR—> i FM TO MULTI-CHAN MAP (1) 


H 
MPOLY.PTR-->{ POLY TO MULTI-CHAN MAP (1) 
' 


1 
USE. PTR==> | USAGE COUNTERS (1) 


CLAV.PTR=->} KEYBOARD BITS (1) 


TBUT. PTR=->| TRACK BUTTON TABLE (1) 


' 
PBN.PTR=->; BUTTON LOOKUP TABLE (2) 


+ 
' 
' 
1 
' 
! 
! 
mS 
aa 
' 
t 
' 
! 
! 
' 
! 
' 
! 
' 
1 
' 
' 
' 

| rn en rn er eee $ 
LOAD.PTR-->{ SPACE TO HOLD LOADER (4) {| 
ren | 
ieee 
i 
' 
' 
' 
! 
' 
' 
1 
' 
' 
' 
' 
' 
' 
! 
' 
' 
' 
! 
! 
1 
' 
' 
' 


KBD.PTR=->{ PRE-COMP KBD PTL BLKS (47) 


NUL. PTR=->! NULL TIMBRE (1) 
IMG.PTR—->} SCREEN IMAGE (4) 
VMAP.PIR—->} MIDI VELOCITY MAP (2) 
TIMAP.PTR—->{ TRANSIT TIME MAP (2) 
FRE.PIR—->} FREQUENCY TABLE (8) 
STB.PIR—> i oe SINE TABLE (1) mae 
LIB.PTR—>} LOG TABLE (4) 


.— 
i nem i iii iim ir ca imc apa aaniaas i 


1 
--+ Ist entry 


1 
1 
‘ 
TIM.HEAD=->{ TIMBRE LOOK UP TABLE (1) 
re — 
| KEYBOARD TRACK HEADER (1) {<~+ 
a ---! ! 
TRK.HEAD=-->{ TRACK LOOK UP TABLE (1) --+ Ist entry 
4: nseocnarereeaemneiiiriceneiiaceansaimuceninabiaaarenint * 
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Section 4 -- Poly Memory 


Poly memory is not directly addressable by the ABLE CPU. It is 
accessed as a device is through the use of XPL "read" and "write" 
statements. Because it is addressed using two registers totalling 24 
bits, it is possible to have a maximum of 32 megabytes of poly 
memory. This is in the process of being increased to 28 address bits 
allowing up to 512 megabytes of poly. 


Poly memory is divided into SECTORS of 256 words each. When 
accessing this memory,” the poly system must have the function code 
set to either read or write to poly memory. Then a single data 
register is used to specify the address and data. The data register 
must receive first the sector address, then the offset into the 
sector, and finally the data word(s). Poly memory accesses always 
eause an auto-increment after each one. 


POLY MEMORY 
SERCO Sa) geen ammnematniionaianis + 
Offset -=>} SECTOR-0 (256 words) H 


! 
1 
: SECTOR-1 (256 words) H 


The values of all of the poly memory function codes are defined 
in :SYNLITS:FCODLITS. The following example reads the first 1024 
words of poly memory into an array in internal memory. Note that the 
procedures PSMREAD(MSB,LSB); and PSMWRITE(MSB,LSB); are usually used 
by the Synclavier software to set up the function code and address 
information. This means the first three statements could be replaced 
with "psmread(0,0);". 


write(PSF) = PSRMA; /* Set the poly system to read memory 
write(PSD) = 0; /* Point at the first sector */ 
write(PSD) = 0; /* No offset into the first sector */ 


’ 
do i=0 to 1023; 
array(i) = read(PSD); /* Read data word (and increment) */ 
end; 


OVERALL STRUCTURE 


Poly memory is primarily used for storing sound files. It is 
possible to load sound information into poly memory, exit the 
Synclavier program, return later and have the sound files still 
present. They are usually only removed when the space is needed for 
other sound files, on command by the user, or when the system is 
powered down. 
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Af 


The system is in the process of being expanded to allow multiple 
poly bins to exist. Each one will have a maximum of 32 voices and 
512 megabytes of memory (former maximum was a single bin with 32 
voices and 32 megabytes of memory). Each bin has its own sound files 
loaded in it, and each bin is having data structured as shown below 
for one bin. iii 


The first sector of poly memory is used to store a small header. 
The "MAGIC NUMBER" and "REVISION" at the start are zeroed out during 
sensitive transitions (eg: loading a new sound file; shuffling the 
existing sound files around) and restored when they are complete. 
This way, if a user manially aborts the Synclavier program while the 
data structures are in transition, everything must be restored from 
the disk. 


POLY MEMORY BIN 
: SYNLITS :SAMPLITS 


POLY HEADER 


1 
! 
! 
' 
i] 
! 


20 SECTORS 
PSFIRST~-> | ----------------------------- '<=-FIRST.BASE = 21 
SOUND FILE BLOCKS 
PSLAST——> | ---------=---------~-------=- ! 
FREE SPACE 
PSMAX=->4----------------------------- +<=-POLYAMOUNT 
POLY HEADER 


The POLY HEADER is stored in the first sector of poly memory. It 
keeps a "MAGIC NUMBER" which means valid data is present if the 
number is preserved. There are also pointers to the other key data 
structures. These pointers are important since the sound file 
information is preserved in poly memory even when the Synclavier 
program is exited. 


The two word pointers (MSB and LSB) are being created to support 


poly bins with greater than 32MB of memory. Older versions of the 
software use single word pointers for PSFIRST through PSHERE. 
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POLY HEADER 


(30071 OCTAL) 
(152077 OCTAL) 


' 
i] 
! 
! 
1 
1 
' 
1 
t 
! 
H 
PSFIRST: MSB,LSB 

Rw meaneseeeatesmencsasmmesesesanen | 
1 

PSLAST: MSB,LSB 
Se — | 
' 

1 

' 

! 

1 

i] 

! 

! 

1 

1 

1 

' 

' 

! 

1 


PSMAX : MSB,LSB 
PSFREE: MSB,LSB 


PSHERE: MSB,LSB 


' 
| (BALANCE OF SECTOR UNUSED) 


20 SECTORS 


Between the POLY HEADER and the SOUND FILE BLOCKS, there are 20 
sectors reserved. This is a scratch area used to store a_ sound 
sample that is displayed on the terminal for in-depth analysis. A 
user can examine this sample in detail (eg: mousing through parts of 
it forward, backward, at varying speeds...). 


SOUND FILE BLOCKS 


The rest of poly memory is reserved for SOUND FILE BLOCKS. These 
are data areas of varying length containing the digitized sound 
samples which can be played back through the poly synthesizer. There 
is one "special" SOUND FILE BLOCK. If the first word of the filename 
is a "1", rather than a printable ASCII character, the block is the 
SOUND FILE CACHE. This is a block of pointers to where all the sound 
files are stored on disk. 
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SOUND FILE BLOCK 


SF .SYM = 2 


BL.POLY = 1024 


i] 
' 
! 
1 
' 
' 
! 
1 
1 
! 
' 
{ 
i 
ONE SECTOR OF FILE HEADER ; SF.HDR = 1 

' 
! 
' 
! 
i 
N SECTORS OF SAMPLE DATA j; 
! 

1 

1 

' 

' 

! 


: SYNLITS: SAMPLITS 
i a a i et al 
BLOCK LENGTH | BL.LEN = 0 
\-— SES FE SS ES SEE NS SS SE SE ae : 
NUMBER OF USERS | BL.USERS = 1 
| pon nn nana nn nnn nn nana nn nanan 
FILENAME - 4 WORDS | BL.FNAME = 2 
| mecenn anne anne nnn nanan 
' FREE SPACE 6 to 19 
\-- 2 an en ares a enen en ateN an an aDan cn anes anes esas an: — 
| BLK OF DATA MATCHING OFFSETS! BL.KEYTC = 20 to 
IN PATCH TIMBRE (PT.*) BL.SAVED = 43 
- iene en aneseset eompanecsnas coat eenentnasenanqrenesen: — 
| FREE - REST OF 1ST SECTOR | 44 to 255 
ae nr er ae ran nen cnr nr nr nr nr nan esses eee ee ee ——<— 
a = 
! 
' 
t 
' 
1 
! 
1 
! 
! 
! 
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pr rn ee nn np 


iFM Synthesizer | 


Section 5 -- Hardware Overview 


1 i 
{Memory (1-32Mb) } 


at eaten lente 


This is a block diagram of the Synclavier hardware system. The 
direct-to-disk system in the lower right is expanded later on. 
The Synclavier Hardware 
- aegeneeabD. + 
}External | 
ji aaemeesaimasee ae ae. : nes: Ok, ce, o_o, +<-| Syne | 
iTerminal; {Mouse} {Guitar and | {Clavier and {| !Keyboard | 4+-------- + 
: emmnes + poco + i1Butt6n Panel{ {Button panel! {Analog I/O} +--------- “ 
. { rs: i ae + prctaaoao --+ {| MIDI |} 
H H = - . {Interface} 
H pore ear aan a= + | H H prmerann n+ 
Steet a ete ete Se po puter etsy on oe 
ret ef Ee conmaaebiis + 4 
pr cm + vvv voev ! v 
{Modem | <-2-- 9-999 9----->ssscasssssssssssssestn+ poem + $occoo-- + 
pr nna + 4 if | SMPTE } fExtern | 
preren n+ Hi 1 1<==> {Interface |<---|Devices } 
tExternal } tt ABLE CPU Hi $rcccenn=— + $rccennn + 
; Memory {<-->}! | | Coeeeeeenere ence enn emnemenenenanamen > aaa 
1 (1=32Mb) } HH HH prewewon= + i Tape} 
goaona-=-+ |! (60K + 4K ROM) |}<----- >{Floppies!} ponent 
it i  ceaecaca ze + 
SSassssssssssssssass Cee Menmneassen na) jasemion + 
i ‘a si 1Printer |} 
H H H aac + 
os +---SCSI---+ 
1 emai + 
1 Vv H {Optical } 
: poco none ------- + | <eeeen- == >| Disk | 
' {Poly Synthesizer | H poco ten— + 
i "hells Tad pata Del i Seaaeememamens + 
Vv {Sample-to-Memory | |<=--=>{Winchesters | 
! ! 
H 
1 
: Riiiaialiniasiniaminianiiami:« ia ia mail + Vv 
1 H » iiieiaceaaeasiaieanieaniaa + 
H Vv v H |Direct-to-Disk | 
H porn srs enna H H System H 
{Multi-Channel ; se aii + 
H | Distributor | H { 
 aiiaaaaiiaiinaiane + i 
1 H H H 
H i H 1 
H { H 1 
' v Vv 1 
' poecereec sna = + H 
H H H H 
poceen anna nanan -->} AUDIO OUTPUT |<----------- + 
1 ' 
' 1 
a a eer + 
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DEVICES AND THEIR ADDRESSES 


The following devices are connected to the ABLE buss to support 
the full configuration shown in the previous diagram: 


D4567 - Multiply/divide (really D4,D5,D6,D7) 

D3 - Real time clock (used to generate 5 msee interrupts) 
Dé - Scientific timer (used to generate 1 msec interrupts) 
D2¥ - SCSI host adaptor 

D30TD - Kennedy 15mb cartridge tape drive 


D32X - Buss extender card containing: 
D32 - Multichannel distributor interface 
DT54-157 - Poly synthesizer interface 


D34 - Guitar and button panel interface 
BHOQ - Combined serial port card containing: 
D4O - Printer port 
Daz - Modem port 
Daa - Mouse port 
D50 - Terminal port 


D60 - External memory interface 


D70 - Combined interface address containing: 
~~~ DF*(8) =- SMPTE interface 
D70=€16) - MIDI interface 


DIOOA - Floppies 

Dt30 - Clavier and button panel interface (velocity keyboard) 
Dt60 - FM synthesizer interface 

DIG0 - Keyboard analog I/O interface (original keyboard only) 
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DIRECT TO DISK 


The direct-to-disk system connects to the main ABLE computer via 
the SCSI buss. It contains another ABLE computer which is the same 
as the main one except it does not boot from a floppy. The boot ROM 
is modified to receive data from the main ABLE over the SCSI; there 
are no floppies or winchester disks on the "Direct-to-disk ABLE". 


The Direct-to-Disk System 


- AadadaanieaaaamimanaNaiagsmeaaa + iSound }{ 
To main ABLE CPU <----------- >| DIRECT-TO-DISK [<---=>{level } 
SCSI i ABLE CPU | MIDI {meter } 
 iaieaiidmemiamiademal ail + ibridge} 
i fom: 
H 
Vv 
aa} jeetee Eeeeey Sa Rea sera amma + 
| Tape {~~ | Disk |---| Disk |--SCSI—} tPoly Synthesizer } 
Fate EE Sette SE toate S Buffer j-> ------- ' 
Pe catia EE toate SE alee 9 iMemory |Sample-to-Memory } 
iTapej-~{Disk}——|Diskj--SCSI-~| le ------- | 
ates a cee es ‘Memory (1-32Mb) } 
° eee Re Oe Re eT: + 
. } 
s Vv 
Up to 8 eee ~ 
pairs of channels 1 } 
each stored on one | AUDIO OUTPUT ; 
or more disks H H 
sear aaan i ieiamde + 
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Appendix 


TERMINOLOGY 


This is a partial list of terms one is likely to encounter when 


reading through the Synclavier code. 


CHANNEL =- A voice allocated in a synthesizer. There must be 
a channel available for each individual sound which occurs 
simultaneously. 


EXTERNAL MEMORY - Memory which is not immediately addressable 
by the ABLE CPU. It is accessed in sectors using 24 address 
bits and therefore may be up to 32 megabytes in size. 
Sequences, timbres and other data is stored here. 


GHOST BLOCK - If a partial block is needed and none are 
available, a search is made to see if there are some decaying 
notes. A GHOST BLOCK is a partial block that is still in 
use, but is for a note which is decaying and will not be 
needed for long. Often, it is better to cut a decaying note 
short rather than avoiding starting a new note on time. 


INTERNAL MEMORY - Memory which is directly available to the 


CPU for instructions and data. Due to the 16-bit ~ 


address space in the processor, it is limited to 64K words. 


LIVE CLICK TRACK - A "metronome" recorded on a track, rather 
than using the one supplied by the Synclavier. This allows 
for changes in tempo during a song. 


LOOPS - An overall loop may be established to cause all the 
tracks to loop between marked "start" and "end" points. An 
"independent" loop may be set up for a single track. 


MP INFO - Music printing info area; the "INF" section of 
external memory. 


NAH - NOTE AREA HEADER; a data structure in external memory. 
NLS - NOTE LIST SEGMENT; a data structure in external memory. 
ORK - The "ORiginal Keyboard" for the Synclavier II. It is 
the predecessor of the "Velocity Keyboard". It has 61 notes 
(C1 to C6). 
PATCH - When a sound files are divided so that different keys 


or ranges of keys on the keyboard generate sound from 
different samples. 
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PINFO AREA - An optional data area in the TIMBRE PARAMETER 
AREA In external memory. It contains extra partial 
information needed in some cases. 


POLY MEMORY =- Memory which is part of the poly synthesizer, 
used primarily for storing sampled sound data. This memory 
is also addressed using 24 bits and may be up to 32 megabytes 
long. This is in the process of being increased to 28 bits 
and 512 megabytes. 


RIBBON — An effect controller located above the keyboard on 
some systems. As you’ slide your finger back and forth on the 
ribbon, an associated sound parameter can be modified. 


RTE - Real-time effects; selectable from the button panel on 
the keyboard. 


SECTOR - A block of memory or disk storage 256 words (512 
bytes) in size. External memory, poly memory and disks are 
accessed in sectors and 8-bit offsets within sectors. 


TIMBRE - A sound or set of sounds available to be played from 

the keyboard (or guitar). Typical timbres include drums, 
flute, trumpet, vibes... They are often produced from 
several samples of these instruments at different pitches and 
then "patched" together to cover the range of the keyboard. 
Or, in the case of percussion for example, different 
instruments may be on different keys. Timbres can also be 
totally synthesized (eg: a sine wave) rather than samples of 
sounds. 


TINFO AREA - An optional data area in the TIMBRE PARAMETER 
AREA in external memory. It contains special real-time 
effects information. 


USAGE KEY NUMBER - A checksum generated for a timbre which 
has a VERY VERY high probability of being unique (though not 
100%). Used to identify a timbre to see if it is already 
loaded without having to compare it bit-for-bit. 


VELOCITY KEYBOARD - The current Synclavier keyboard which is 
velocity and pressure sensitive. It is often refered to 
as the "New Keyboard". It has 76 notes (AO to C7). 


WESTERN SCALE - The "standard" 12-tone scale: C, C#, D, D#, 
E eee Ad 9 B. 


VOICE - A channel allocated in a synthesizer. There must be 


a voice available for each individual sound which occurs 
simultaneously. 
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XPL TRICKS 


These are some of the more unusual constructs you will find when 
reading through the Synclavier code. 


‘core(0)* - This can be used as a literal definition, for 
example: 
DCL OVERALL.VOLUME LIT 'CORE(0)'; ~ 

This is sometimes done when a section of code containing a 
literal is conditiohed out, but will not make it through the 
first passes of the compiler without SOME value. core(0) is 
not guaranteed to contain anything useful to most programs, 
so care must be taken not to actually use the value in real 
code. 


FREE.RO; - This is a literal defined to be the (seemingly 
useless) code: 
IF O THEN WRITE("300") = READ("300"); 

This statment is optimized out by the third pass of the 
compiler. Its purpose is to trick the XPL compiler into 
thinking that RO ("300") has just been used. Then one can 
write some assembler code like "write("301") = a + b;" to put 
a value into R1 for some extra fast piece of code. Since the 
compiler always allocates registers using RO first, you know 
the addition of a and b will be done in RO, and R1 will be 
free for your use. 


REMINDERS - Sometimes you will see "dead" code like: 
IF POLY.SPLICE THEN DO; END; 
This is put in place as a reminder so that later you can find 
it to put real code in. By removing the literal definition 
of POLY.SPLICE compile errors will be generated if you forget 
to replace one of these constructs with real code. 


RPT nnn; - An XPL literal construct used with the Model-C (or 
newer) processor only. It causes the next single word 
instruction to be executed nnn times. The execution takes 
place in micro-code as “one instruction cycle" for the 
processor so it is not interruptable! Care should be taken 
not to make these loops too large (usually limited to RPT 
64;). It is FAST though. 


SWAPABLE - A literal defined as "RECURSIVE SWAP", Most 
swapping procedures in the Synclavier source are declared 
with this pseudo-keyword. Note that swapping procedures may 
NOT be called during an interrupt. 


REGISTER 13 - The code: 
WRITE("313") = SOMETHING; 
is storing a number directly in register 13. XPL never uses 
R13, so it is available as a very fast variable within a 
procedure. 
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NOTE NAMES 


When notes are stored in the Synclavier software, they are 
generally numbered from 0 to 84 with #36 as "middle-C". This is 
convenient since 85 keys is (3 * 255). The keyboard look up table 
for example is three words per key and fits in one sector of external 
memory. It is also seven full octaves C-C. The keys are named as 
follows: 


NOTES NUMBERED 
Co - BO 0-11 
C1 - B1 12 = 23 
C2 - B2 24 = 35 
C3 - B3 36 - 47 
C4 = BY 48 - 59 
C5 - BS 60 - 71 
C6 - B6 72 - 83 
C7 84 


Sometimes other designations are used for notes and pitches. 
MIDI uses keys numbered from 1 to 127 where 60 is "middle-C". 


"Pitch class numbers" use numbers of the form "0.SSCC" where "0" 
is the octave (corresponding to the octave numbers in the table 
‘above, eg: A3 is in octave 3), SS is the semi-tone (0 to 11) and CC 
is the number of cents (hundredths of a semi-tone). Using this 
notation, "3.0900" would be "A3" (A at 440 Hz); "3.0000" would be 
"C3" ("middle-C" or C at 523.3 Hz). 


The original keyboard has a range of 61 notes from C1 to C6. The 
new velocity keyboard is 76 notes from AO to C7. 
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